GetMenuItemRefCon2

GetMenuItemRefCon2
Header:	Menus.h		Carbon status:	Unsupported

Obtains application-specific information for a menu item.

OSErr GetMenuItemRefCon2 (
    MenuHandle inMenu, 
    SInt16 inItem, 
    UInt32 *outRefCon2
);

inMenu: A handle to the menu that contains the menu item for which you wish to retrieve information.
inItem: An integer representing the item number of the menu item.
outRefCon2: A pointer to an unsigned 32-bit integer value. On return, the value is set to the reference constant associated with the menu item.

function result: A result code.

DISCUSSION

If you have assigned any data to a given menu item using SetMenuItemRefCon2 function, you can read it using the GetMenuItemRefCon function.

See also the function SetMenuItemRefCon2.

VERSION NOTES

This function is available with Appearance Manager 1.0 and later.

AVAILABILITY

Not supported in Carbon. Not available in CarbonLib, but available when AppearanceLib 1.0 or later is installed. Exported by AppearanceLib 1.0 and later.

CARBON NOTES

To associate data with a menu item you should instead use the Get/SetMenuItemProperty functions available with the Mac OS 8.5 Menu Manager.